# MPV Scripts

## Save Properties

Saves the properties specified by the user every time MPV is exited, and applies them when MPV is started.

#### Options

- **properties:** Comma-separated list of the properties to save. (Default=`"volume,sub-scale"`)

## Screenshot to Farbfeld

Saves screenshots in Farbfeld format in MPV's default screenshot directory (`XDG_PICTURES_DIR/mpv` if not specified). It does that by converting a temporary PNG screenshot (add `screenshot-png-compression=0` to your mpv.conf for maximum performance).

#### Options

- **bzip2:** Applies bzip2 compression to the screenshot (and saves it in `.ff.bz2`) if is set to 1, it doesn't (and saves the screenshot in `.ff`) otherwise. (Default=`1`)
- **screenshot_subtitles:** Keybinding for taking the screenshot in subtiltes mode (with subtitles and OSD). (Default=`s`)
- **screenshot_video:** Keybinding for taking the screenshot in video mode (no subtitles/OSD). (Default=`s`)
- **screenshot_windows:** Keybinding for taking the screenshot in window mode (window as it appears on screen). (Default=`Ctrl+s`)

## Clock

Displays an OSD clock.

#### Options

- **format:** The time format. (Default=`%_H:%M%S`)
- **ass_position:** Position of the clock in ass format (1=left, 2=center, 3=right for the horizontal alignment, 0=bottom, 4=top, 8=middle for the vertical alignment; the sum is the position). (Default=`7`)
- **show_clock_binding:** Binding to show the clock for a short period of time. (Default=`Ctrl+c`)
- **toggle_clock_binding:** Binding to toggle the displaying of a permanent clock. (Default=`Ctrl+C`)


# How to use

Put the `.lua` file in your `~/.config/mpv/scripts` and the configuration file (optional) in an homonymous `.config` file in `~/.config/mpv/script-opts`.
